home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / qbbs / ava40.zip / AVA.DOC next >
Text File  |  1991-02-14  |  36KB  |  1,651 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.                        **  #  # ###  ##  #     #  ##  ### ### ###
  20.                       *  * #  #  #  #  # ##   ## #  #  #  #   #  #
  21.                       **** #  #  #  #  # # # # # ####  #  ##  #  #
  22.                       *  *  ##   #   ##  #  #  # #  #  #  ### ###
  23.  
  24.                  *   * ### ###  ### ### ###  ###  ##  ### ###  ##  #  #
  25.                  *   * #   #  #  #  #    #  #    #  #  #   #  #  # ## #
  26.                   * *  ##  ###   #  ##   #  #    ####  #   #  #  # # ##
  27.                    *   ### #  # ### #   ###  ### #  #  #  ###  ##  #  #
  28.             
  29.                        **  #    ##   ##  ###  ### ### #  # #     #
  30.                       *  * #   #    #  # #  #  #   #  #  # ##   ##
  31.                       **** #   # ## #  # ###   #   #  #### # # # #
  32.                       *  * ###  ##   ##  #  # ###  #  #  # #  #  #
  33.                                           and
  34.                           Automated Verification Algorithm SF
  35.  
  36.                         The SysOp's Answer to Caller Verification 
  37.                             (c) 1989, 1990, 1991 by Cat Miller
  38.  
  39.  
  40.                              This program is supported by:
  41.                                        Cat Miller
  42.                                 Off-The-Wall Programing
  43.                             13610 N. Scottsdale RD. STE 146
  44.                                Scottsdale, Arizona  85254
  45.  
  46.  
  47.                      Documentation by Cat Miller and Geoffrey Booher
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.   TABLE OF CONTENTS
  77.   =================
  78.  
  79.  
  80.   PREFACE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
  81.         Disclaimer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
  82.   Introduction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
  83.   Files and Features. . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
  84.   Configurable options. . . . . . . . . . . . . . . . . . . . . . . . . . . 6
  85.   Installing AVA - QuickBBS . . . . . . . . . . . . . . . . . . . . . . . . 7
  86.   Installing AVA - RemoteAccess . . . . . . . . . . . . . . . . . . . . . . 8
  87.   Installing AVA - SpitFire . . . . . . . . . . . . . . . . . . . . . . . . 8
  88.   Batch File for QuickBBS . . . . . . . . . . . . . . . . . . . . . . . . . 9
  89.   Configuring AVA . . . . . . . . . . . . . . . . . . . . . . . . . . . . .10
  90.   Optional Command Line Parameter . . . . . . . . . . . . . . . . . . . . .11
  91.   Phonenum.Ava - External file. . . . . . . . . . . . . . . . . . . . . . .12
  92.   NoCall.Num - External number checker. . . . . . . . . . . . . . . . . . .14
  93.   External text files - Ansi codes. . . . . . . . . . . . . . . . . . . . .15
  94.   AVAText.Exe - The Utility. . . . . . . . . . . . . . . . . . . . . . . . 15
  95.   SysOp Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .16
  96.   From the Beginning. . . . . . . . . . . . . . . . . . . . . . . . . . . .17
  97.        From the Beginning (cont)  . . . . . . . . . . . . . . . . . . . . .18
  98.   Derrors.Txt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .19
  99.   Registration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .20
  100.        Registration (cont) . . . . . . . . . . . . . . . . . . . . . .  . .21
  101.   Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .22
  102.   Gratitude . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .23
  103.   Acknowledgements. . . . . . . . . . . . . . . . . . . . . . . . . . . . .23
  104.   Appendix A. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .24
  105.        cont . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .25
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.   PREFACE
  143.  
  144.  
  145.   Disclaimer
  146.   ----------
  147.  
  148.   Automated Verification Algorithm and its utilities is provided AS IS, without
  149.   warranty of any kind, expressed or implied. In no way shall OTW Programming
  150.   or Cat Miller be held liable for any damages by use or misuse of the
  151.   forementioned program and utilities.  Your use of these programs imply your
  152.   acceptance of these terms and you will bear full responsibility.
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.   Page 4
  206.  
  207.  
  208.  
  209.  
  210.  
  211.   Introduction
  212.   ------------
  213.  
  214.   AVA is an acronym for Automated Verification Algorithm. It is a SysOp
  215.   utility designed to call back and verify first time callers. The time
  216.   spent voice validating every caller can be very consuming. Since most of us
  217.   are computer hobbyists time is something we'd rather spend tinkering instead
  218.   of dialing.
  219.  
  220.   AVA is very flexible and can be customized to suit your needs by way of the
  221.   many configurable options. These options are covered in detail in Avacfg.Doc.
  222.  
  223.   User friendliness are the key words. AVA is straightforward and doesn't
  224.   utilize coined computer words or phrases. A neophyte doesn't need the added
  225.   confusion brought upon by a simple task such as validation. The minimum key
  226.   strokes expected from a caller are five. AVA is simple yet powerful.
  227.  
  228.   SysOps can expect the same user friendliness. The configuration utility is
  229.   menu driven. This alleviates all of the hassles of putting together another
  230.   configuration file with your word processor.
  231.  
  232.   AVA was written with QuickBasic 4.5. A 'DTR' patched version of BRUN45.EXE,
  233.   the external run time library, is included for AVA to run. We decided to
  234.   distribute it with AVA because many SysOps were complaining about locating
  235.   it.  Place the Brun45.Exe file somewhere in your DOS path.
  236.  
  237.   AVA has been tested on many computers, however there are a few requirements.
  238.  
  239.     o QuickBBS 2.xx, RemoteAccess 0.xx or 1.00, SpitFire 3.0
  240.     o An IBM PC, AT or 100% BIOS compatible
  241.     o Hayes compatible asynchronous modem
  242.     o CGA card/monitor
  243.     o DOS 3.x or greater
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.         Automated Verification Algorithm (c) 1989, 1990, 1991 by Cat Miller
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.   Page 5
  272.  
  273.  
  274.  
  275.  
  276.  
  277.   Files
  278.   -----
  279.  
  280.   The following files were distributed in the .ZIP archive:
  281.  
  282.  
  283.   Ava.Exe............................The Main AVA Program
  284.   Ava.Doc............................This documentation text file
  285.   Avacfg.Exe.........................AVA Setup utility
  286.   Avacfg.Doc.........................Documentation for above
  287.   Avadat.Doc.........................Structure for Ava.Dat file
  288.   AvaText.Exe........................Preview utility for *.Asc files
  289.   Remove.Exe.........................External Ava.Dat utility *
  290.   Remove.Doc.........................Documentation for above  *
  291.   Phonenum.Ava.......................Sample Phonenum.Ava control file
  292.   Register.Ava.......................Registration Form to register AVA
  293.   NoCall.Num.........................List of non-callable areacodes/prefixes
  294.   Thelist.Ava........................List of registered AVA SysOp's
  295.   Question.Ava.......................Common questions from SysOp's about AVA
  296.   Whatsnew.Ava.......................Notes on changes with AVA by version
  297.   Brun45.Exe.........................QuickBasic Runtime Module required
  298.   ErrCodes.Txt.......................List of error codes
  299.   SFBat.Doc..........................Included with SpitFire version
  300.  
  301.   External configurable text files:
  302.  
  303.   First.Asc..........................Opening screen displayed to caller
  304.   Second.Asc.........................Final screen displayed before calling
  305.   NoCall.Asc.........................Displayed if number found in NoCall.Num
  306.   YouAre.Asc.........................Displayed to already verified callers
  307.   EditNum.Asc........................To explain why NOT to edit phonenumber
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.         Automated Verification Algorithm (c) 1989, 1990, 1991 by Cat Miller
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.   Page 6
  338.  
  339.  
  340.  
  341.  
  342.  
  343.   Configurable options and features
  344.   ---------------------------------
  345.  
  346.     Long distance or toll calling
  347.     Grant minimum access to long distance or toll callers
  348.     Edit phone numbers before calling
  349.     Verify duplicate phone numbers
  350.     Long distance calling for verification ONLY
  351.     Toll numbers calling for verification ONLY
  352.     Run AVA in Verify Only Mode
  353.   * Daily download byte limit for both minimum and verified access
  354.     Daily time limit for both minimum and verified access
  355.   * All four FLAGS, A, B, C and D are supported.  Previous settings
  356.     respected.
  357.     Long distance or toll calling during specified times ONLY
  358.     Recognizes local calls even if area code differs
  359.     Modem handshake support
  360.     Supports baud rates from 300 to 38400 (locked or unlocked)  
  361.     ATDT or ATDP dialing
  362.     Define minimum minutes remaining before AVA will dial out
  363.     Formats 'free-style' phone numbers
  364.     Specify path on command line
  365.     Optional external file to check for valid area code and prefixes
  366.     Define phone numbers and combination of numbers that you will
  367.     absolutely NOT call
  368.     Display screens
  369.     Embed ansi codes
  370.   * Recognizes RemoteAccess 1.00 AVATAR flags in Dorinfox.Def
  371.     ...and more!
  372.  
  373.   * Not supported by SpitFire systems
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.         Automated Verification Algorithm (c) 1989, 1990, 1991 by Cat Miller
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.   Page 7
  404.  
  405.  
  406.  
  407.  
  408.  
  409.   Installing AVA - QuickBBS
  410.   -------------------------
  411.  
  412.   Use a TYPE 15 menu option to run AVA with QuickBBS.  Please refer to your
  413.   QuickBBS documentation regarding this kind of menu setup.  The following
  414.   files must be present in the same directory as AVA.Exe:
  415.  
  416.   Ava.Cfg
  417.   PhoneNum.Ava   (optional)
  418.   First.Asc
  419.   Second.Asc
  420.   YouAre.Asc
  421.   NoCall.Asc
  422.   EditNum.Asc    (optional)
  423.  
  424.   AVA and its associated files need not be run from your main BBS directory.
  425.   You can use the optional drive\path command line parameter which will be
  426.   explained later.  For simplicity sake, this documentation will illustrate the
  427.   installation of AVA in your bbs main directory.  AVA utilizes Phonedup.Log
  428.   and Phonenum.Ctl so specifying a path to your bbs main directory is necessary
  429.   if you intend to run AVA from its own directory.  For further information
  430.   about Phonedup.Log, Phonenum.Ctl please refer to your bbs documentation.
  431.  
  432.   After you have set up your TYPE 15 menu option, set the errorlevel in which
  433.   to exit with, you need to add this to your QuickBBS or front end mailer
  434.   batch file.  See the batch file example for QuickBBS on the following page.
  435.  
  436.   Note:  AVA has been successfully setup with SuperBBS.  Use the QuickBBS setup
  437.   directions for use with SuperBBS.
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.         Automated Verification Algorithm (c) 1989, 1990, 1991 by Cat Miller
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.   Page 8
  470.  
  471.  
  472.  
  473.  
  474.  
  475.   Installing AVA - RemoteAccess
  476.   -----------------------------
  477.  
  478.   Use a TYPE 7 menu option to run AVA with RemoteAccess.  RemoteAccess *M
  479.   can swap all but 20k of RA out of memory to disk.  RA creates both
  480.   DORINFO1.DEF and EXITINFO.BBS with a TYPE 7 exit, and rereads both files
  481.   upon return (unlike Quick) so using a TYPE 7 with RemoteAccess is the
  482.   recommended method.  TYPE 15's are not needed with RA.
  483.  
  484.   Using a TYPE 7 menu option, the AVA command would be entered like this:
  485.  
  486.   Optional Data:  Ava.Exe Ava.Cfg *M
  487.  
  488.   That's all there is to it.  Note:  DOOR conversion utilities that are
  489.   available to convert QuickBBS to RA and back to QuickBBS are *NOT* needed.
  490.  
  491.   Also, RemoteAccess TYPE 7 installation eliminates the need for a batch file
  492.   to run AVA.
  493.  
  494.  
  495.   AVA 4.0 will also recognise the new AVATAR codes in DORINFO?.DEF for
  496.   RemoteAccess 1.00.  If the caller has AVATAR ONLY selected, they will be
  497.   shown an ASCII screen.  If the caller has ANSI and AVATAR selected, they
  498.   will be shown the ANSI screens.  A future version of AVA will support
  499.   AVATAR display screen codes.
  500.  
  501.  
  502.  
  503.  
  504.  
  505.   Installing AVA - SpitFire
  506.   -------------------------
  507.  
  508.   AVA can be run as a Door or menu extension.  Please refer to your SpitFire
  509.   documentation for installation information.
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.         Automated Verification Algorithm (c) 1989, 1990, 1991 by Cat Miller
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.   Page 9
  536.  
  537.  
  538.  
  539.  
  540.  
  541.   Batch File for QuickBBS
  542.   -----------------------
  543.  
  544.   Echo Off
  545.   Cls
  546.   Echo ***** Loading QuickBBS Now *****
  547.  
  548.   :Start
  549.    QuickBBS -E0
  550.  
  551.   :After_Quick
  552.    If Errorlevel 10 Goto AVA
  553.    If Errorlevel 9  Goto RightHere
  554.    If Errorlevel 8  Goto Somewhere
  555.    If Errorlevel 0  Goto Start
  556.  
  557.   :AVA
  558.    Ava Ava.Cfg  <--- Configuration filename supplied on the command line
  559.    Goto Restart
  560.  
  561.   :RightHere
  562.    Rem -  Doing something here
  563.  
  564.   :Somewhere
  565.    Rem - Do something else here
  566.  
  567.   :Restart
  568.    QuickBBS -R -E0
  569.    Goto After_Quick
  570.  
  571.   For this example an ErrorLevel 10 signifies the use of AVA. Control will
  572.   resume at the label :AVA. When AVA is completed the batch file jumps to the
  573.   label Restart to reinstate the bbs.  Note, labels ARE case sensitive!
  574.  
  575.   Of course your batch file will be different.
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.         Automated Verification Algorithm (c) 1989, 1990, 1991 by Cat Miller
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.   Page 10
  602.  
  603.  
  604.  
  605.  
  606.  
  607.   Configuring AVA
  608.   ---------------
  609.  
  610.   AVA requires a configuration file. The filename must be supplied on the
  611.   command line. Example:
  612.  
  613.   D:\> Ava Ava.Cfg
  614.  
  615.   Detailed information on the various configurable options are covered in
  616.   AVACFG.DOC.  They will not be covered in this documentation.
  617.  
  618.  
  619.  
  620.  
  621.  
  622.  
  623.  
  624.  
  625.  
  626.  
  627.  
  628.  
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.         Automated Verification Algorithm (c) 1989, 1990, 1991 by Cat Miller
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.   Page 11
  668.  
  669.  
  670.  
  671.  
  672.  
  673.   Optional Command Line Parameter
  674.   -------------------------------
  675.  
  676.   You can specify a drive\path to your bbs main directory.  This allows you to
  677.   run AVA from its own directory.  If a FULL drive\path is not specified, AVA
  678.   will default to the current drive\directory.
  679.  
  680.   Examples:
  681.  
  682.   Loading and running AVA specifying a path:
  683.  
  684.   D:\QBBS\AVA> Ava Ava.Cfg D:\Qbbs\
  685.  
  686.      ) The ending backslash is required when specifying a path
  687.  
  688.   Loading and running AVA without specifying a path:
  689.  
  690.   D:\QBBS> Ava Ava.Cfg
  691.  
  692.  
  693.   SpitFire systems:
  694.  
  695.   If you intend on running AVA from its own directory, then you will need to
  696.   copy the appropriate *.Dat to your AVA directory prior to running AVA.
  697.   When AVA returns control to you batch file, copy the .Dat back to its
  698.   original directory.  This is so SpitFire will read the updated .Dat file
  699.   prior to running itself.
  700.  
  701.         Sample SpitFire batch:
  702.  
  703.         :AVA
  704.         Copy C:\SF\SFDoors.Dat
  705.         AVA AVA.Cfg C:\SF\Work\
  706.         Copy SFDoors.Dat c:\sf
  707.  
  708.   This also holds true if you intend on running AVA from a SFSEC<xx>.Bat file.
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.         Automated Verification Algorithm (c) 1989, 1990, 1991 by Cat Miller
  720.  
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.  
  732.  
  733.   Page 12
  734.  
  735.  
  736.  
  737.  
  738.  
  739.   PhoneNum.Ava - External file
  740.   ----------------------------
  741.  
  742.   AVA will optionally use an external ASCII file known as Phonenum.Ava to
  743.   check for valid phone numbers.  Valid phone numbers are numbers that AVA
  744.   will call and verify.   You can create this text file with your text editor.
  745.  
  746.   PhoneNum.Ava uses its own keywords and format. The keywords are Local, Toll,
  747.   LD and End.  The use of these keywords help in AVA's calling decisions as
  748.   well as create a more descriptive and informative log file.
  749.  
  750.   PhoneNum.Ava will use by default the following number formats:
  751.  
  752.   Local numbers:    xxx-xxxx
  753.   Toll numbers:     1-xxx-xxxx
  754.   LD numbers:       1-xxx-xxx-xxxx
  755.  
  756.   The format of PhoneNum.Ava follows:
  757.  
  758.   File: Phonenum.Ava
  759.  
  760.   ; Text following a semi colon are ignored.  Use the semi colon for
  761.   ; comments.  Entries must follow the format of this example.  Local phone
  762.   ; numbers are entered first then Toll and LD phone numbers.
  763.   ; calling area.
  764.   Local                ; Local keyword to signify local phone numbers
  765.   602-951- 951-        ; Areacode-prefix followed by dial string
  766.   602-788-             ; No dial string will default to Local format xxx-xxxx
  767.   Toll                 ; Toll keyword to signify toll phone numbers
  768.   602-342- 1-602-342-  ; Areacode-prefix followed by dial string
  769.   602-587-             ; No dial string use default: 1-xxx-xxxx
  770.   LD                   ; LD keyword to signify long distance phone numbers
  771.   808-                 ; No dial string use LD default 1-xxx-xxx-xxxx
  772.   LD                   ; OR
  773.   808-623 1-808-623    ; Use 1-808-623 to call this number
  774.   End                  ; End of list - must be the last entry in the list
  775.  
  776.   Since PhoneNum.Ava is read in order, the first matching sequence is what is
  777.   used.  When a match is found, AVA will use the associated dial string to
  778.   call or if there is no associated dial string, AVA will use the predefined
  779.   default.  So long as you define a dial string, AVA will use it.  If no match
  780.   is found, AVA will act according to its associated option as found in Ava.Cfg.
  781.  
  782.  
  783.  
  784.  
  785.         Automated Verification Algorithm (c) 1989, 1990, 1991 by Cat Miller
  786.  
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.  
  797.  
  798.  
  799.   Page 13
  800.  
  801.  
  802.  
  803.  
  804.  
  805.   PhoneNum.Ava (cont)
  806.   -------------------
  807.  
  808.   Since the function of PhoneNum.Ava is to determine whether the caller is a
  809.   local call from your system, you should include all of your local area
  810.   codes and prefixes.
  811.  
  812.   If you do not plan to support Toll or LD calls,  then it is not necessary to
  813.   include those keywords in PhoneNum.Ava. 
  814.  
  815.   Selectively omitting numbers from Phonenum.Ava will ensure that those numbers
  816.   will not be called.
  817.  
  818.   Phonenum.Ava must reside in the same directory as AVA.  If you do not wish
  819.   to use this method of checking phone numbers, AVA will ask the caller if
  820.   he is a local call.  However, AVA will check the phone number using its
  821.   internal checking processes regardless of the answer.
  822.  
  823.   Do not include remarks after a dial string.  The remarks you see here are
  824.   there for your benefit only.
  825.  
  826.   A sample PhoneNum.Ava is included with the distribution archive.
  827.  
  828.  
  829.  
  830.  
  831.  
  832.  
  833.  
  834.  
  835.  
  836.  
  837.  
  838.  
  839.  
  840.  
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.         Automated Verification Algorithm (c) 1989, 1990, 1991 by Cat Miller
  852.  
  853.  
  854.  
  855.  
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.  
  863.  
  864.  
  865.   Page 14
  866.  
  867.  
  868.  
  869.  
  870.  
  871.   NoCall.Num - External number checker
  872.   ------------------------------------
  873.  
  874.   NoCall.Num is an ASCII file containing portions of or entire telephone
  875.   numbers which you will absolutely not call.  What makes this different from
  876.   PhoneNum.Ava is that the caller's phone number(s) is checked prior to the
  877.   display of First.Asc.  If the caller's number is found in NoCall.Num, AVA
  878.   will not proceed with verification but instead will display NoCall.Asc and
  879.   return the caller to your bbs.
  880.  
  881.   If your system supports home and data phone numbers then AVA will check both
  882.   numbers against the entries in NoCall.Num.  If one of the numbers is found,
  883.   then it will be ignored and AVA will use only the valid number.
  884.  
  885.   The syntax for NoCall.Num is different from PhoneNum.Ava.  NoCall.Asc uses
  886.   the x as a mask.  Valid entries would be:
  887.  
  888.   xxx-911-
  889.   xxx-411-
  890.   xxx-976-
  891.   111-
  892.   000-
  893.   333-
  894.   602-951-8534
  895.  
  896.   As you can see, you can use portions of a number or include the entire
  897.   number.  It wouldn't be a bad idea to include your bbs number, police
  898.   station, fire department or any combination.
  899.  
  900.   Do not include remarks in this file.  They will be treated as valid entries.
  901.  
  902.   A sample NoCall.Num is included with the distribution archive.
  903.  
  904.  
  905.  
  906.  
  907.  
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.         Automated Verification Algorithm (c) 1989, 1990, 1991 by Cat Miller
  918.  
  919.  
  920.  
  921.  
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.  
  929.  
  930.  
  931.   Page 15
  932.  
  933.  
  934.  
  935.  
  936.  
  937.   External Text Files - Ansi codes
  938.   --------------------------------
  939.  
  940.   The use of external text files allow you to customize the instructions and
  941.   information according to your setup.  AVA now supports the use of embedded
  942.   ansi codes.  The external files, First.Asc, Second.Asc, YouAre.Asc and
  943.   NoCall.Asc must be in the same directory as AVA.  A fifth and optional
  944.   text file, EditNum.Asc should also be in the same directory if you intend
  945.   on supporting the editing of phone numbers.
  946.  
  947.   The ~ symbol is what alerts AVA to the presence of an ansi code.  You must
  948.   preceed each numeric code with this symbol.  Due to its limitation, you
  949.   cannot use ~ anywhere else in your text file.  This will be corrected in
  950.   a future version.
  951.  
  952.   The following is a list of codes recognized by AVA:
  953.  
  954.   ~01  Blue           ~09  Bright Blue
  955.   ~02  Green          ~10  Bright Green
  956.   ~03  Cyan           ~11  Bright Cyan
  957.   ~04  Red            ~12  Bright Red
  958.   ~05  Magenta        ~13  Bright Magenta
  959.   ~06  Brown          ~14  Yellow
  960.   ~07  White          ~15  Bright White
  961.  
  962.   Included is a little utility AVAText.Exe which will display on the local
  963.   console your .Asc file.  This utility is helpful when creating your
  964.   screens.  It will ensure that you have your screens just the way you want
  965.   them.  AVAText can be envoked directly from DOS or supplied with a
  966.   filename, ie:
  967.  
  968.             d:> AVAText First.Asc
  969.  
  970.   AVAText will instantly display First.Asc.  If no filename was supplied on the
  971.   command line then you will be prompted for a filename.
  972.  
  973.   These external files are included in the archive as examples or they can be
  974.   used as is.
  975.  
  976.  
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.         Automated Verification Algorithm (c) 1989, 1990, 1991 by Cat Miller
  984.  
  985.  
  986.  
  987.  
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.  
  995.  
  996.  
  997.   Page 16
  998.  
  999.  
  1000.  
  1001.  
  1002.  
  1003.   SysOp Commands
  1004.   --------------
  1005.  
  1006.   The options available to the SysOp while a caller is online are:
  1007.  
  1008.   ALT + C      Chat
  1009.   ALT + H      Hangup the caller
  1010.   ALT + J      Jump to DOS
  1011.   ALT + L      Lock out caller
  1012.   ALT + R      Return caller to BBS
  1013.   HOME         More help
  1014.   END          Normal Window
  1015.   Cursor UP    Add 1 minute to caller's time
  1016.   Cursor DOWN  Subtract 1 minute from caller's time
  1017.  
  1018.   Chat
  1019.   ----
  1020.   Online chat has word wrapping.  However, the caller's online time is still
  1021.   affected while in chat.  Press [Esc] to exit chat and return to AVA.
  1022.  
  1023.   Hangup the caller
  1024.   -----------------
  1025.   This is a true twit key. That is, DTR is dropped thereby disconnecting the
  1026.   caller from AVA and your BBS. AVA will sense the loss of carrier and
  1027.   graciously return control to your BBS.  A twit is a twit.  This option works
  1028.   only if there is a caller online.
  1029.  
  1030.   Jump to DOS
  1031.   -----------
  1032.   This is your Shell to DOS key. To return to AVA type EXIT at the dos prompt.
  1033.  
  1034.   Lock out caller
  1035.   ---------------
  1036.   The ALT + H taken a degree furthur.  This will zero out the caller's security
  1037.   level and hangup the caller.
  1038.  
  1039.   Return caller to bbs
  1040.   --------------------
  1041.   This will promptly bring the caller back to your BBS.  This works whether
  1042.   or not there is a caller presently online.
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.         Automated Verification Algorithm (c) 1989, 1990, 1991 by Cat Miller
  1050.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.  
  1062.  
  1063.   Page 17
  1064.  
  1065.  
  1066.  
  1067.  
  1068.  
  1069.   From the Beginning
  1070.   ------------------
  1071.  
  1072.   AVA retrieves the phone number(s), security level and password from
  1073.   EXITINFO.BBS or SFDoors.Dat for SpitFire systems.  The phone number(s) and
  1074.   security level are checked.  AVA will not accept callers whose security
  1075.   levels are greater then the minimum access securtiy level and lower then the
  1076.   SysOp's security level as defined in your configuration file.  If this is
  1077.   found to be true, the contents of YouAre.Asc is displayed to the caller then
  1078.   is return to your bbs.  AVA will also compare the caller's phone number(s)
  1079.   with that which you have defined in NoCall.Num.  If there is a match, AVA
  1080.   will display to the caller the contents of NoCall.Asc and return the caller
  1081.   to your bbs.
  1082.  
  1083.   Once the caller gets past this check, the first text screen, First.Asc, is
  1084.   displayed to the caller.  It should inform the caller what he can expect
  1085.   from AVA and what AVA expects from the caller.  Please keep this in mind
  1086.   when editing First.Asc.  This file is provided in the distribution file. You
  1087.   may use this as an example or use it as is.
  1088.  
  1089.   After reading this screen, the caller is prompted to whether or not he wants
  1090.   to proceed with the verification.  Depending on the caller's reply he will
  1091.   either be returned to your bbs or proceed with the verification.
  1092.  
  1093.   If your system requires both the home and data phone number from the caller,
  1094.   then AVA will ask which one to call.  If you have configured AVA so that
  1095.   callers may edit their phone numbers, it will then ask if he wishes to edit
  1096.   the phone number.  If the caller successfully edits the phone number, both
  1097.   the edited number and the original number is written to AVA.Log.  The caller
  1098.   is given 2 chances to edit the number.  After the second attempt the caller
  1099.   is returned to the bbs. 
  1100.  
  1101.   Second.Asc is the last screen the caller sees before AVA disconnects.  As
  1102.   per the example included in the distribution file, it is the 'last chance'
  1103.   screen and is used to remind the caller to use ATA to answer the phone, etc.
  1104.   You can edit this file as you wish.
  1105.  
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.         Automated Verification Algorithm (c) 1989, 1990, 1991 by Cat Miller
  1116.  
  1117.  
  1118.  
  1119.  
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.  
  1127.  
  1128.  
  1129.   Page 18
  1130.  
  1131.  
  1132.  
  1133.  
  1134.  
  1135.   From the Beginning (cont)
  1136.   -------------------------
  1137.  
  1138.   Once connection is re-established AVA will clear its buffers, synchronize the
  1139.   modems and announce itself to the caller.  At this point the caller is
  1140.   expected to answer 2 questions.  The first question asks for the caller's
  1141.   first and last names and the second question asks for his password.  The
  1142.   password entry is masked.  That is, *'s are echoed to the remote screen while
  1143.   what is actually typed is echoed to the local screen.
  1144.  
  1145.   The caller will have 2 chances each to answer both questions.  If either one
  1146.   of the questions are not answered correctly, verification will fail.
  1147.  
  1148.   After successfully answering both questions the new security level, download
  1149.   byte limit and flags A, B, C and D will be written to EXITINFO.BBS.  This is
  1150.   where QuickBBS retrieves its information upon returning from a TYPE 15 exit.
  1151.   The caller is returned to the BBS, verified and with a higher access level.
  1152.  
  1153.   For SpitFire systems AVA will update the appropriate .Dat and SFUsers.Dat.
  1154.   If you will be using AVA in it's own directory, you will need to copy
  1155.   the appropriate .Dat from the AVA directory to your bbs directory so that
  1156.   SpitFire will read in the updated caller information.
  1157.  
  1158.   AVA keeps a log of activities in the file AVA.LOG.  This file keeps a running
  1159.   record of what occurred and did not occur during the verification process.
  1160.   The log is appended to each time AVA is accessed.  You can delete it when it
  1161.   becomes too large.
  1162.  
  1163.   In addition, AVA accesses Phonedup.Log and Phonenum.Ctl.  If for some reason
  1164.   a duplicate phone number was not detected by QuickBBS it will not be written
  1165.   to Phonedup.Log.  However, AVA also maintains an external data file called
  1166.   Ava.Dat.  The caller's name, phone number and time\date of verification is
  1167.   stored in this file.  AVA also checks this data file for duplicate numbers.
  1168.  
  1169.  
  1170.  
  1171.  
  1172.  
  1173.  
  1174.  
  1175.  
  1176.  
  1177.  
  1178.  
  1179.  
  1180.  
  1181.         Automated Verification Algorithm (c) 1989, 1990, 1991 by Cat Miller
  1182.  
  1183.  
  1184.  
  1185.  
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192.  
  1193.  
  1194.  
  1195.   Page 19
  1196.  
  1197.  
  1198.  
  1199.  
  1200.  
  1201.   Derrors.Txt
  1202.   -----------
  1203.  
  1204.   AVA will create or append a file called Derrors.Txt whenever it encounters
  1205.   an error.  Loss of carrier is also treated as an error and will be noted in
  1206.   this file.  If you are experiencing trouble setting up or running AVA more
  1207.   than likely it will be listed in Derrors.Txt.
  1208.  
  1209.   You should delete this file as it becomes unwanted.
  1210.  
  1211.  
  1212.  
  1213.  
  1214.  
  1215.  
  1216.  
  1217.  
  1218.  
  1219.  
  1220.  
  1221.  
  1222.  
  1223.  
  1224.  
  1225.  
  1226.  
  1227.  
  1228.  
  1229.  
  1230.  
  1231.  
  1232.  
  1233.  
  1234.  
  1235.  
  1236.  
  1237.  
  1238.  
  1239.  
  1240.  
  1241.  
  1242.  
  1243.  
  1244.  
  1245.  
  1246.  
  1247.         Automated Verification Algorithm (c) 1989, 1990, 1991 by Cat Miller
  1248.  
  1249.  
  1250.  
  1251.  
  1252.  
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258.  
  1259.  
  1260.  
  1261.   Page 20
  1262.  
  1263.  
  1264.  
  1265.  
  1266.  
  1267.   Registration
  1268.   ------------
  1269.  
  1270.   You are hereby granted permission to evaluate AVA for 30 days.  After this
  1271.   evaluation period a $20.00 registration fee is required.  If you do not plan
  1272.   to register, then remove AVA from use.
  1273.  
  1274.   Upon receipt of your registration fee, a serial number will be issued to you.
  1275.   Use this serial number to register your copy of AVA with AVACFG.  Once you
  1276.   have registered your copy you will no longer see [Evaluation] [Copy].  When
  1277.   AVA is operating you will see your FULL serial number in the upper right hand
  1278.   portion of your screen.  When seeking help, comments or suggestions please
  1279.   include your FULL serial number.
  1280.  
  1281.   Please use the file Register.Ava to send in your registration information.
  1282.  
  1283.   Send your information, plus $20.00 check or money order (US Funds) to:
  1284.  
  1285.   OTW Programming
  1286.   c/o Cat Miller
  1287.   13610 N. Scottsdale RD STE 146
  1288.   Scottsdale, AZ  85254
  1289.  
  1290.   Please make checks or money order payable to Cat Miller.
  1291.  
  1292.  
  1293.  
  1294.  
  1295.  
  1296.  
  1297.  
  1298.  
  1299.  
  1300.  
  1301.  
  1302.  
  1303.  
  1304.  
  1305.  
  1306.  
  1307.  
  1308.  
  1309.  
  1310.  
  1311.  
  1312.  
  1313.         Automated Verification Algorithm (c) 1989, 1990, 1991 by Cat Miller
  1314.  
  1315.  
  1316.  
  1317.  
  1318.  
  1319.  
  1320.  
  1321.  
  1322.  
  1323.  
  1324.  
  1325.  
  1326.  
  1327.   Page 21
  1328.  
  1329.  
  1330.  
  1331.  
  1332.  
  1333.   Registration (cont)
  1334.   -------------------
  1335.  
  1336.   Your registration number is generated based on the bbs name as well as the
  1337.   SysOp's name.  If you change your name or your bbs name, then you will need
  1338.   to aquire another registration number.  To do this, you must supply your
  1339.   previous information and your 'old' registration number.  Also, include
  1340.   your new information.  If you do not supply your 'old' registration number
  1341.   then the request will be ignored.  This is for your protection only.
  1342.  
  1343.   Your registration number is valid for future versions of AVA unless otherwise
  1344.   noted.  The cost of registration is subject to change without notice.
  1345.  
  1346.   Due to the increasing flow of netmail regarding AVA, it has become necessary
  1347.   for me to place your replies on hold.  If you have sent netmail and expect a
  1348.   reply, you may begin polling my system for a reply after 48 hours.
  1349.  
  1350.  
  1351.   Non $20.00 registrations postmarked after February 1st, 1991 will require a
  1352.   $5.00 upgrade fee.
  1353.  
  1354.  
  1355.  
  1356.  
  1357.  
  1358.  
  1359.  
  1360.  
  1361.  
  1362.  
  1363.  
  1364.  
  1365.  
  1366.  
  1367.  
  1368.  
  1369.  
  1370.  
  1371.  
  1372.  
  1373.  
  1374.  
  1375.  
  1376.  
  1377.  
  1378.  
  1379.         Automated Verification Algorithm (c) 1989, 1990, 1991 by Cat Miller
  1380.  
  1381.  
  1382.  
  1383.  
  1384.  
  1385.  
  1386.  
  1387.  
  1388.  
  1389.  
  1390.  
  1391.  
  1392.  
  1393.   Page 22
  1394.  
  1395.  
  1396.  
  1397.  
  1398.   Support
  1399.   -------
  1400.  
  1401.   Updates and or new releases of AVA can be downloaded or file requested from
  1402.   the support board, The Alternate Choice, 114/39, (602)951-8534,
  1403.   300/1200/2400 and 24 hours a day.  The magic filename: AVA will get you the
  1404.   latest version.
  1405.  
  1406.   If you are installing AVA for the first time I will offer assistance.
  1407.   You may leave your questions, comments and suggestions to Cat Miller if I
  1408.   am not available for chat.
  1409.  
  1410.   If you are experiencing problems, you need to be exact with your description
  1411.   of the problem.  Include as much detail as possible such as computer hardware,
  1412.   TSR's, fossil driver, your AVA configuration, a listing of your Derrors.Txt
  1413.   file and so forth.  This kind of detail will help tremendously in tracking
  1414.   down the problem.
  1415.  
  1416.   You may also contact the following Support Systems for assistance.
  1417.  
  1418.   * AVA Distribution/Support System *
  1419.  
  1420.   SysOp:    Geoffrey Booher
  1421.   BBS:      The Gateway Net BBS - a FrontDoor/RemoteAccess System
  1422.             14.4 HST / 14.4 V.32bis / 9600 V.32 / V.42bis
  1423.   FidoNet:  1:11/233
  1424.   Number:   (815)233-5008 23 hrs.  Freeport, IL - USA
  1425.   Comments: FREQ magicname: AVA for the latest version
  1426.             QuickBBS, RemoteAccess, SuperBBS support USA
  1427.  
  1428.   * AVA SF Distribution/Support System *
  1429.  
  1430.   SysOp:    Russell Mikami - SpitFire System
  1431.   BBS:      The Hawaiian Hawke BBS - a SpitFire system
  1432.             9600 V.32 / 14.4 HST
  1433.   FidoNet:  1:114/67
  1434.   Number:   (602)272-4887 24 hrs.  Phoenix, AZ - USA
  1435.   Comments: Fido netmail - SpitFire support
  1436.  
  1437.  
  1438.  
  1439.  
  1440.  
  1441.  
  1442.  
  1443.  
  1444.  
  1445.         Automated Verification Algorithm (c) 1989, 1990, 1991 by Cat Miller
  1446.  
  1447.  
  1448.  
  1449.  
  1450.  
  1451.  
  1452.  
  1453.  
  1454.  
  1455.  
  1456.  
  1457.  
  1458.  
  1459.   Page 23
  1460.  
  1461.  
  1462.  
  1463.  
  1464.  
  1465.   Gratitude
  1466.   ---------
  1467.  
  1468.   Geoffrey Booher for his comments and suggestions for version 1.0 and
  1469.   later.  He has been very instrumental in the release of version 4.0 as well
  1470.   as the release that is soon to follow.
  1471.  
  1472.   Bob Lucas for his comments and suggestions for version 1.1f and earlier.
  1473.   Also for his willingness to beta test version 2.0.
  1474.  
  1475.   Travis Smith for his willingness to beta test version 2.0.
  1476.  
  1477.   Todd DolBeer for his patience and support in testing and correcting an
  1478.   oversight in the modem routine.
  1479.  
  1480.   Lance Alexander for his help in beta testing AVA.
  1481.   His is reachable at Cactus Quick Net 7:800/9
  1482.  
  1483.   Jason Harper for his help in beta testing AVA.
  1484.   His is reachable at 114/46.
  1485.  
  1486.   Bruce Bodger for his help in corrections/fixes to AVA.
  1487.   He is at The Truckstop BBS - 1:170/400
  1488.  
  1489.  
  1490.   Acknowledgements
  1491.   ----------------
  1492.  
  1493.   QuickBasic 4.5 a product of MicroSoft.
  1494.   QuickC com library used by AVA is written and developed by Jeff Sumberg.
  1495.   RemoteAccess is a product of Continental Software.
  1496.   QuickBBS 2.6x is a product of the QuickBBS Group.
  1497.  
  1498.  
  1499.  
  1500.  
  1501.  
  1502.  
  1503.  
  1504.  
  1505.  
  1506.  
  1507.  
  1508.  
  1509.  
  1510.  
  1511.         Automated Verification Algorithm (c) 1989, 1990, 1991 by Cat Miller
  1512.  
  1513.  
  1514.  
  1515.  
  1516.  
  1517.  
  1518.  
  1519.  
  1520.  
  1521.  
  1522.  
  1523.  
  1524.  
  1525.   Page 24
  1526.  
  1527.  
  1528.  
  1529.  
  1530.  
  1531.   Appendix A
  1532.   ----------
  1533.  
  1534.   Currently we are using a US Robotics MicroLink 2400. The dip switches on my
  1535.   internal modem are set as follows:
  1536.  
  1537.  
  1538.    1     2    3    4    5    6    7    8   9   10
  1539.   OFF   ON   OFF  ON   ON   OFF  OFF  ON  OFF  ON
  1540.  
  1541.  
  1542.   Switch #  Description
  1543.   --------  -----------
  1544.     1       Data terminal ready override
  1545.             OFF = DTR Normal; Pin 20 controls modem
  1546.             ON = DTR is always on
  1547.  
  1548.     2       Verbal, numeric result codes
  1549.             OFF = Verbal (word) messages
  1550.             ON = Numeric result codes
  1551.  
  1552.     3       Result code display
  1553.             OFF = Quiet mode, no display
  1554.             ON = Result codes displayed
  1555.  
  1556.     4       Modem echo
  1557.             OFF = Modem echoes commands sent from keyboard
  1558.             ON = Modem does not echo
  1559.  
  1560.     5       Auto Answer
  1561.             OFF = Modem answers on first ring
  1562.             ON = Auto answer suppressed
  1563.  
  1564.     6       RS-232 Carrier Detect Pin
  1565.             OFF = Pin 8 controls carrier detect
  1566.             ON = Carrier detect signal is always on
  1567.  
  1568.     7       Single/Multi-line installation
  1569.             OFF = Single phone
  1570.             ON = Multiple phones
  1571.  
  1572.  
  1573.  
  1574.  
  1575.  
  1576.  
  1577.         Automated Verification Algorithm (c) 1989, 1990, 1991 by Cat Miller
  1578.  
  1579.  
  1580.  
  1581.  
  1582.  
  1583.  
  1584.  
  1585.  
  1586.  
  1587.  
  1588.  
  1589.  
  1590.  
  1591.   Page 25
  1592.  
  1593.  
  1594.  
  1595.  
  1596.  
  1597.   cont
  1598.   ----
  1599.  
  1600.  
  1601.     8       AT command set recognition
  1602.             OFF = AT command set disabled
  1603.             ON = Normal operations
  1604.  
  1605.  
  1606.     9       Escape Code Operations
  1607.             OFF = Modem disconnects when +++ is entered.
  1608.             ON = Modem returns to command state when +++ is entered.
  1609.  
  1610.  
  1611.   10        Volume control
  1612.             OFF = Low volume
  1613.             ON = High volume
  1614.  
  1615.  
  1616.   AVA lowers DTR to disconnect the remote caller. Your modem must respect this.
  1617.   If you leave DTR ON the caller will never be disconnected and AVA will try
  1618.   desperately to lower it.  After a certain amount of time the program will
  1619.   terminate and verification will not be performed.  The desired Hayes AT
  1620.   commands to have are &C1 - software controls carrier detect and &D2 - 
  1621.   software controls data terminal ready.  AVA will not work properly if the DCD
  1622.   and DTR are FORCED on.
  1623.  
  1624.  
  1625.  
  1626.  
  1627.  
  1628.  
  1629.  
  1630.  
  1631.  
  1632.  
  1633.  
  1634.  
  1635.  
  1636.  
  1637.  
  1638.  
  1639.  
  1640.  
  1641.  
  1642.  
  1643.         Automated Verification Algorithm (c) 1989, 1990, 1991 by Cat Miller
  1644.  
  1645.  
  1646.  
  1647.  
  1648.  
  1649.  
  1650.  
  1651.